Clarify documentation for selection modes. (#154188, Jonathan Blandford,

2004-10-06  Matthias Clasen  <mclasen@redhat.com>

	* gtk/tmpl/gtkenums.sgml: Clarify documentation for selection
	modes.  (#154188, Jonathan Blandford, new wording proposed by
	Owen Taylor)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index b39969dd7ab57563fad9e1bb8adbdd0ee2527066..78517ee8c0135ddbb314366bdd43460f75e8a73f 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,9 @@
+2004-10-06  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/tmpl/gtkenums.sgml: Clarify documentation for selection
+       modes.  (#154188, Jonathan Blandford, new wording proposed by
+       Owen Taylor)
+
 2004-10-05  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/gtk-sections.txt: Add gtk_accelerator_get_label().

diff --git a/docs/reference/gtk/tmpl/gtkenums.sgml b/docs/reference/gtk/tmpl/gtkenums.sgml
index 1a58ba7b7c21f6142e94f8eed76eb73bd987f62c..73785000522ab2b115fd8004fda5cec0a61d0b16 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkenums.sgml
+++ b/docs/reference/gtk/tmpl/gtkenums.sgml
@@ -332,20 +332,22 @@ Indicated the relief to be drawn around a #GtkButton.
 
 <!-- ##### ENUM GtkSelectionMode ##### -->
 <para>
-
+Used to control what selections users are allowed to make.
 </para>
 
 @GTK_SELECTION_NONE: No selection is possible.
 @GTK_SELECTION_SINGLE: Zero or one element may be selected.
-@GTK_SELECTION_BROWSE: Exactly one element is always selected 
-   (this can be false after you have changed the selection mode).
+@GTK_SELECTION_BROWSE: Exactly one element is selected. In some circumstances,
+  such as initially or during a search operation, it's possible for no element 
+  to be selected with %GTK_SELECTION_BROWSE. What is really enforced is that 
+  the user can't deselect a currently selected element except by selecting 
+  another element.
 @GTK_SELECTION_MULTIPLE: Any number of elements may be selected. 
    Clicks toggle the state of an item. Any number of elements may be selected. 
    Click-drag selects a range of elements; the Ctrl key may be used to enlarge 
    the selection, and Shift key to select between the focus and the child 
    pointed to.
-@GTK_SELECTION_EXTENDED: Deprecated, behaves identical to 
-   %GTK_SELECTION_MULTIPLE.
+@GTK_SELECTION_EXTENDED: Deprecated, behaves identical to %GTK_SELECTION_MULTIPLE.
 
 <!-- ##### ENUM GtkShadowType ##### -->
 <para>